home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / tcsetpgrp.0 < prev    next >
Text File  |  1996-09-02  |  2KB  |  49 lines
  1.  
  2. TCSETPGRP(3)               UNIX Programmer's Manual               TCSETPGRP(3)
  3.  
  4. NNAAMMEE
  5.      ttccsseettppggrrpp - set foreground process group ID
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssyyss//ttyyppeess..hh>>
  9.      ##iinncclluuddee <<uunniissttdd..hh>>
  10.  
  11.      _i_n_t
  12.      ttccsseettppggrrpp(_i_n_t _f_d, _p_i_d___t _p_g_r_p___i_d)
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      If the process has a controlling terminal, the ttccsseettppggrrpp function sets
  16.      the foreground process group ID associated with the terminal device to
  17.      _p_g_r_p___i_d. The terminal device associated with _f_d must be the controlling
  18.      terminal of the calling process and the controlling terminal must be cur-
  19.      rently associated with the session of the calling process.  The value of
  20.      _p_g_r_p___i_d must be the same as the process group ID of a process in the same
  21.      session as the calling process.
  22.  
  23.      Upon successful completion, ttccsseettppggrrpp returns a value of zero.
  24.  
  25. EERRRROORRSS
  26.      If an error occurs, ttccggeettppggrrpp returns -1 and the global variable _e_r_r_n_o is
  27.      set to indicate the error, as follows:
  28.  
  29.      [EBADF]       The _f_d argument is not a valid file descriptor.
  30.  
  31.      [EINVAL]      An invalid value of _p_g_r_p___i_d was specified.
  32.  
  33.      [ENOTTY]      The calling process does not have a controlling terminal,
  34.                    or the file represented by _f_d is not the controlling termi-
  35.                    nal, or the controlling terminal is no longer associated
  36.                    with the session of the calling process.
  37.  
  38.      [EPERM]       The _p_g_r_p___i_d argument does not match the process group ID of
  39.                    a process in the same session as the calling process.
  40.  
  41. SSEEEE AALLSSOO
  42.      setpgid(3),  setsid(2),  tcgetpgrp(3)
  43.  
  44. SSTTAANNDDAARRDDSS
  45.      The ttccsseettppggpprrpp function is expected to be compliant with the IEEE
  46.      Std1003.1-1988 (``POSIX'') specification.
  47.  
  48. BSD Experimental               September 2, 1996                             1
  49.